package cn.iocoder.yudao.module.reading.service.page;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.reading.controller.admin.page.vo.BookPageCreateReqVO;
import cn.iocoder.yudao.module.reading.controller.admin.page.vo.BookPagePageReqVO;
import cn.iocoder.yudao.module.reading.controller.admin.page.vo.BookPageUpdateReqVO;
import cn.iocoder.yudao.module.reading.dal.dataobject.book.BookPageDO;

import java.util.List;

/**
 * 管理员绘本页面 Service 接口
 *
 * @author 芋道源码
 */
public interface AdminBookPageService {

    /**
     * 创建绘本页面
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createBookPage(BookPageCreateReqVO createReqVO);

    /**
     * 更新绘本页面
     *
     * @param updateReqVO 更新信息
     */
    void updateBookPage(BookPageUpdateReqVO updateReqVO);

    /**
     * 删除绘本页面
     *
     * @param id 编号
     */
    void deleteBookPage(Long id);

    /**
     * 获得绘本页面
     *
     * @param id 编号
     * @return 绘本页面
     */
    BookPageDO getBookPage(Long id);

    /**
     * 获得绘本页面分页
     *
     * @param pageReqVO 分页查询
     * @return 绘本页面分页
     */
    PageResult<BookPageDO> getBookPagePage(BookPagePageReqVO pageReqVO);

    /**
     * 根据绘本ID获取页面列表
     *
     * @param bookId 绘本ID
     * @return 页面列表
     */
    List<BookPageDO> getBookPagesByBookId(Long bookId);

    /**
     * 批量创建绘本页面
     *
     * @param createReqVOs 创建信息列表
     * @return 编号列表
     */
    List<Long> batchCreateBookPages(List<BookPageCreateReqVO> createReqVOs);

    /**
     * 获取下一个绘本页面ID
     * 用于在创建页面之前获得真实ID，避免文件上传时的临时ID问题
     *
     * @return 下一个将要分配的页面ID
     */
    Long getNextBookPageId();

}
